package com.example.demo.service;

import com.example.demo.model.User;
import java.util.List;
import java.util.Optional;

/**
 * 用户服务接口
 * 定义用户相关的业务逻辑操作
 */
public interface UserService {
    
    /**
     * 注册新用户
     * @param user 用户信息
     * @return 注册成功的用户
     * @throws IllegalArgumentException 如果邮箱已存在则抛出异常
     */
    User registerUser(User user);
    
    /**
     * 获取所有用户
     * @return 用户列表
     */
    List<User> getAllUsers();
    
    /**
     * 根据ID查找用户
     * @param id 用户ID
     * @return 查找到的用户
     */
    Optional<User> getUserById(Long id);
    
    /**
     * 根据邮箱查找用户
     * @param email 用户邮箱
     * @return 查找到的用户
     */
    Optional<User> getUserByEmail(String email);
    
    /**
     * 删除用户
     * @param id 用户ID
     */
    void deleteUser(Long id);
    
    /**
     * 判断邮箱是否已存在
     * @param email 用户邮箱
     * @return 如果邮箱已存在返回true，否则返回false
     */
    boolean isEmailExists(String email);
} 